home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / os2 / fm2_240.zip / READ.ME < prev    next >
Text File  |  1996-01-21  |  17KB  |  340 lines
  1.  ┌──────────────────────────────────────────────────────────────────────────┐
  2.  │F(ile) M(anager)/2 copyright (c) 1993-96 by M. Kimes  (Barebones Software)│
  3.  │                            All Rights Reserved                           │
  4.  ├──────────────────────────────────────────────────────────────────────────┤
  5.  │                READ.ME file -- read before installing                    │
  6.  │        See end of document for contact info and license details          │
  7.  └──────────────────────────────────────────────────────────────────────────┘
  8.  
  9.  
  10. File Manager/2 (FM/2) is a shareware OS/2 2.1+ PM 32-bit
  11. file/directory/archive maintenance utility (a sort of super-Drives
  12. object, something midway between the Drives objects and a more
  13. traditional file manager) with plenty of bells, whistles and utilities,
  14. drag and drop, context menus, toolbars and accelerator keys.  If you
  15. know how to use OS/2, you already know how to use most of FM/2.  You can
  16. easily glean the rest from the extensive online help, including
  17. tutorials.
  18.  
  19. This document explains how to install FM/2, including upgrading from
  20. previous versions.  It explains command line syntaxes and how to get the
  21. program(s) running.  The online help tells you how to actually use FM/2.
  22. A separate document (history.txt) lists changes for this version.
  23. Another (register.txt) tells you how to register FM/2.  If you're
  24. interested, there're well over 110 printed pages of documentation in
  25. this package, counting only this file and the online help -- did I write
  26. all that?
  27.  
  28. The license agreement and author contact info is at the bottom of the
  29. file.
  30.  
  31.  
  32. FM/2 2.x installation instructions:
  33. ==================================
  34.  
  35.    1. Unpack the FM2*.ZIP archive in a private directory (UNZIP.EXE
  36.       works nicely).  FM/2 2.x requires its own home directory (FAT or
  37.       HPFS, doesn't matter). I recommend that it _not_ be your old FM/2
  38.       1.x directory (and don't delete the old 1.x version until after
  39.       you install, so the install program can migrate some of your old
  40.       settings and registration first).  If upgrading from 2.x, just
  41.       unpack the files in the FM/2 2.x directory and go (you might want
  42.       to skip ARCHIVER.BB2 if you've customized it).
  43.  
  44.   2.  Run the provided INSTALL.CMD (a simple REXX program) in that
  45.       directory to build a folder and program objects and migrate some
  46.       old INI information.  Rerun INSTALL.CMD if you later move the FM/2
  47.       directory.  (If you later decide to remove FM/2, run UNINSTAL.CMD
  48.       in the FM/2 2.x directory and follow simple directions.  Both
  49.       installation and deinstallation are no-brainers.  UNINSTAL will
  50.       help you quickly and easily remove all traces of FM/2 from your
  51.       system if you don't like it for some reason.  All OS/2 programs
  52.       should be so nice.)  INSTALL sets up some associations for you
  53.       unless you give it NOASSOC as an argument.
  54.  
  55.   3.  Run it.  Have fun.  Full help is available from within the
  56.       program.  If you're unfamiliar with OS/2's WPS, please take the
  57.       time to run the OS/2 Tutorial before attempting to use FM/2, as
  58.       FM/2 uses many of the same conventions.
  59.  
  60.  
  61. Starting FM/2:
  62. =============
  63.  
  64. If you start File Manager/2 (filename FM3.EXE) with no command line
  65. arguments, it opens the Drive Tree window but no directory windows
  66. (unless the "Save state of dir windows" toggle is checked -- see online
  67. help).
  68.  
  69. File Manager/2 optionally accepts names of directories on the command
  70. line; it'll open a directory window for each one.  Hint:  If you often
  71. do different specific things with FM/2, you might set up a WPS object
  72. customized to start up ideally for each activity.  For example, if you
  73. wanted to maintain your BBS areas, you might have one object like:
  74. "FM3.EXE D:\BBSDIR D:\BBSDIR\MAILIN", and if you also like to use FM/2
  75. to set icons on files, you might have another object like:  "FM3.EXE
  76. E:\MYICONS D:\NEWFILES".  The State userlist can also be used for this
  77. within FM/2 itself -- see online help.
  78.  
  79. You can exclude drives on the command line by prefacing the drive letter
  80. with "/", and there can be more than one drive letter behind the "/"
  81. (i.e. "FM3.EXE /BH" to exclude both drives B: and H:).  Hint:  Many
  82. people like to use /B to exclude "phantom" drive B: if they have a
  83. single-floppy system.  Similarly, you can cause drives NOT to be
  84. prescanned by the Drive Tree by prefacing the drive letter with ";",
  85. drives NOT to load icons for objects by prefacing the drive letter with
  86. ",", drives NOT to load subjects for objects by prefacing the drive
  87. letter with "`" and drives NOT to load longnames for objects by
  88. prefacing the drive letter with "'".  This can be handy if you have a
  89. very slow drive like a CD-ROM or Zip drive.
  90.  
  91. If you place the argument "+" on the command line, FM/2 will log, to
  92. FM2.LOG, delete, rename, move and copy operations that are performed by
  93. drag-and-drop or with the menus.
  94.  
  95. The command line argument "-" causes FM/2 to ignore, not load or save,
  96. the previous state of directory windows (see the "Save state of dir
  97. windows" toggle under Config Menu->Toggles in the online help) for that
  98. invocation.
  99.  
  100.  
  101. Installation notes:
  102. ==================
  103.  
  104. Please read the following sections in the online help when you start
  105. FM/2 for the first time:  "How to use FM/2's Help," "Terminology" and
  106. "General Help," then "Hints."  The rest you can browse as you get
  107. time/feel the need; for instance, if you want to know what a toggle
  108. does, read the help under Settings notebook->Toggles page.
  109.  
  110. If you prefer hardcopy help, print this file, run FM/2, press CTRL+F1,
  111. click the "Print" button at the bottom of the help window that appears
  112. and then print both the "Contents" and "All sections" (keep an eye on
  113. the printer around page 100 of "All sections" as the Help Manager will
  114. begin printing its own help then -- you may want to abort printing at
  115. that point).  Advanced and/or curious users may also want to print
  116. FM3TOOLS.DAT and ARCHIVER.BB2.  Be sure you have plenty of paper and ink
  117. handy -- the package is well documented.  You'll probably also want a
  118. three-ring binder and hole punch to get it bound, as staples aren't
  119. going through that puppy.
  120.  
  121. You may want to either move ARCHIVER.BB2 (the data file containing
  122. information about archiver programs and archive files) to a directory in
  123. your PATH= statement or erase this one if you've customized an old one.
  124. FM/2 can still find, use and maintain ARCHIVER.BB2 on the PATH; it
  125. doesn't have to be in FM/2's directory (this allows it to be used by
  126. other programs as well, like XGroup, XBBS/2, LA, AV, ZTreeBold, etc.).
  127. Remember, FM/2 needs OS/2, not DOS, archivers.
  128.  
  129. If FM/2 refuses to run, the most likely culprit is CONFIG.SYS.  Your
  130. LIBPATH statement should contain "." or ".\" (shorthand for "the default
  131. directory"), as in:  LIBPATH=.;C:\OS2\DLL;C:\OS2\MDOS;<etc.>  This is
  132. the default OS/2 installation, but a few folks, or programs they've
  133. installed, have changed it.
  134.  
  135. I've separated many of the standalone utilities that I used to include
  136. with FM/2 into another archive (FM2UTILS.ZIP).  Since I update the
  137. utilties far less frequently than FM/2 itself, this allows you to
  138. download less and still keep up to date.  To get the maximum use out of
  139. FM/2, you should pick up the package.  If you can't find it where you
  140. found this archive, bug your sysop to pick it up.
  141.  
  142.  
  143. Bonus programs:
  144. --------------
  145.  
  146. You'll note the extra objects that the Install program creates in the
  147. File Manager/2 folder.  FM/2 is modular, so that you can get directly to
  148. some of its components without running the entire ball of wax.  This may
  149. allow you to enhance the behavior of some of your other applications in
  150. the WPS tradition.  You don't _have_ to keep these around, of course --
  151. FM/2 itself contains all their functionality.
  152.  
  153.   Archive Viewer/2:   Intended for drag-and-drop operation (or WPS
  154.                       association) with WPS objects or other
  155.                       applications.  Drag an archive onto it, drop it,
  156.                       get an archive listing box.  FM/2's installation
  157.                       program sets up some associations between archive
  158.                       files and this program by file extension (run
  159.                       INSTALL with "NOASSOC" as an argument if you don't
  160.                       want them).  AV/2 will try to display whatever
  161.                       you give it as sensibly as it can.  Filename AV2.EXE.
  162.  
  163.   SysIcon:            Intended to let you change a system pointer by
  164.                       dragging an icon/pointer file (*.ICO or *.PTR)
  165.                       onto it, then picking the pointer to replace. You
  166.                       can reset a pointer by starting it without
  167.                       arguments.  Filename DOICON.EXE.
  168.  
  169.   EA Viewer:          Drag a file system object onto it and it'll show
  170.                       you the object's extended attributes.  Filename
  171.                       EAS.EXE.
  172.  
  173.   INI Viewer:         Drag an .INI file onto it and it'll show you its
  174.                       contents.  Filename INI.EXE.
  175.  
  176.   Bookshelf Viewer:   Shows all .INF files in a listbox and lets you
  177.                       pick the one(s) you want to view.  If you give any
  178.                       command line argument, the .HLP files on the HELP
  179.                       path will be shown instead (the Helpfile Viewer
  180.                       object calls VIEWINFS.EXE with "dummy" for an
  181.                       argument, for example).  Filename VIEWINFS.EXE.
  182.  
  183.   Process Killer:     Lets you kill off renegade processes.  An English
  184.                       version of PSTAT.EXE must be on your PATH.
  185.                       Filename KILLPROC.EXE.
  186.  
  187.   Undeleter:          Lets you undelete files (via interface with
  188.                       UNDELETE.COM).  Drag a file system object onto it
  189.                       and it'll let you undelete files for that drive.
  190.                       Filename UNDEL.EXE.
  191.  
  192.   Visual Tree:        Opens a Drive Tree window (like the WPS Drives
  193.                       object with more horsepower).  Filename VTREE.EXE.
  194.  
  195.   Visual Directory:   Opens a Directory Container window; drag a file
  196.                       system object onto it and this will open its
  197.                       directory (like a WPS directory Folder with more
  198.                       horsepower).  Filename VDIR.EXE.
  199.  
  200.   Collector:          Opens a Collector window.  Filename VCOLLECT.EXE.
  201.                       Two other objects, "See all files" and "Seek and
  202.                       scan" are created which call up the Collector and
  203.                       go directly to dialogs for the appropriate
  204.                       purpose.
  205.  
  206.   Global Viewer:      Opens a global view of a drive or drives.  Filename
  207.                       GLOBAL.EXE.
  208.  
  209.   Databar:            Opens a databar showing some system information.
  210.                       Filename DATABAR.EXE.
  211.  
  212.   SysInfo:            Shows information about your system.  Filename
  213.                       SYSINFO.EXE
  214.  
  215. FM/2's install creates FM2.CMD, AV2.CMD, VDIR.CMD, VTREE.CMD,
  216. VCOLLECT.CMD, UNDEL.CMD, KILLPROC.CMD, INI.CMD, EAS.CMD, VIEWINFS.CMD
  217. and VIEWHELP.CMD files for you in a directory "utils" off the install
  218. directory.  You should add this directory to your PATH= statement in
  219. CONFIG.SYS (type HELP PATH at a command line for more info).  If you
  220. prefer, FM/2's INSTALL builds a SETENV.CMD in the FM/2 directory which
  221. you can call to set the PATH for FM/2 in any given session without
  222. modifying CONFIG.SYS.
  223.  
  224. Note that registered diskette versions come with even more bonus
  225. programs.
  226.  
  227.  
  228. Additional documentation:
  229. ========================
  230.  
  231.   Register.txt:   How to register FM/2.
  232.  
  233.  
  234. FM/2 isn't free, it's shareware:
  235. ===============================
  236.  
  237. To register FM/2, fill out REGISTER.TXT and send to the mailing address
  238. listed in it, together with the purchase price (commercial users,
  239. there's a 5% discount for each ten commercial licenses, up to one
  240. hundred licenses, where the price flattens, so you get a total 50%
  241. discount on each license for one hundred or more licenses in one order
  242. -- see REGISTER.TXT for a table).  Registration gets rid of the initial
  243. about box and closing screen, eases your conscience and makes the world
  244. safe for truth, justice, the democratic way and further FM/2 updates,
  245. not necessarily in that order.  I also include some things that might
  246. be useful with FM/2 if you order the disks.
  247.  
  248. Registrations are good for one year or one full version change (i.e.
  249. 2.00 -> 3.01), whichever comes last.  Versions before a full version
  250. change stay registered forever.  Considering the price, the program and
  251. the upgrade policy, I don't think you can beat FM/2 with a stick.  But
  252. then, I'm a prejudiced jerk.
  253.  
  254. (Someone asked me why registrations are cheaper for personal use than
  255.  for commercial use.  I thought it was obvious, but I guess it's not.  I
  256.  feel that individual, private use of software should be cheaper than
  257.  use in an environment where it's contributing to making money.  I feel
  258.  that much software is already priced far too high for individual,
  259.  private users as it is, and therefore I give individual, private users
  260.  a 50% break.  It just seems fair to me, and I've got to live with
  261.  myself.  Please don't bother trying to send me a commercial check for
  262.  a personal registration -- I don't even return them any more, I just
  263.  throw them away.)
  264.  
  265. If you have a CIS address, _be sure_ to fill it in on REGISTER.TXT.
  266. You'll get your registration information much more quickly that way. You
  267. can also register online via Compuserve's Shareware Registration service
  268. (GO SWREG) and is #2859 for personal registrations, #4228 for commercial
  269. -- warning: the price is a bit higher to give CIS a cut (CIS will show
  270. it to you first).  Support is currently being provided in the CIS OS/2
  271. Shareware forum (GO OS2SHARE) and regular updates are posted there.
  272.  
  273. NEW:  Registrations can also be obtained through BMT Micro using credit
  274. ===   cards (see BMTORDER.FRM in the archive).
  275.  
  276. Speaking of updates, I tend to put them up _very_ regularly
  277. (incrementing the version number by .01 each time, with occassional
  278. letter increments between).  I'm one of those fellows who likes to
  279. always have some new software to play with, so I figure others might,
  280. too.  Besides, it's fun.  Don't feel obligated to get each new release
  281. if you don't like updating.  You can FTP FM/2 from ftp.secret.com
  282. (/g/os2utl).
  283.  
  284.  
  285. Technical stuff:
  286. ===============
  287.  
  288. There are some limitations to FM/2, imposed by OS/2's remaining 16-bit
  289. subsystems (hopefully future versions of OS/2 will remove some or all of
  290. these -- some have already been eliminated since OS/2 2.0).
  291.  
  292. If FM/2 won't run, the probable culprit is CONFIG.SYS.  Your LIBPATH
  293. statement should contain a ".\" entry.  If yours doesn't, add it in.
  294. It's standard for an OS/2 installation, but some ill-tempered install
  295. programs accidentally knock it out.
  296.  
  297.  
  298. LAN troubleshooting:
  299. -------------------
  300.  
  301. FM/2 has been tested by users with the following LAN software:
  302.  
  303. LAN Server:   No known problems.
  304.  
  305. TCP/IP:       No known problems.
  306.  
  307. Novell:       Earlier versions had problems that have been corrected.
  308.               If you encounter problems, upgrade.
  309.  
  310. LANtastic:    Somewhat buggy -- contact Artisoft and ask for a fix.
  311.               They know about the problems but could use some "guidance"
  312.               from their users.
  313.  
  314.  
  315.                 +----------------------------------------+
  316.                 |  IMPORTANT!  Read before distributing! |
  317.                 +----------------------------------------+
  318.  
  319. Simple license statement:
  320. ========================
  321.  
  322. You are granted a license to try this shareware program (FM/2) for up to
  323. thirty (30) days, after which you must register or discontinue its use.
  324. Permission is granted to redistribute the unaltered shareware archive
  325. for a reasonable (read nominal, small) copying charge (FM/2 may
  326. specifically not be packaged with a commercial book without requesting
  327. and obtaining permission (common courtesy -- remember, "copyright" means
  328. literally "the right to control who copies the material").  If you write
  329. a review on FM/2, I'd certainly appreciate a courtesy copy of the
  330. review -- my wife collects them.).  All rights are reserved by the
  331. author.  That's me.
  332.  
  333. There is NO warranty.  Support is NOT guaranteed to unregistered users.
  334.  
  335.  
  336. Contact info:
  337. ============
  338.   Mark Kimes (CIS 74601,1327; Fidonet#1:380/16.0; (318)222-3455 data
  339.               mkimes@linux.secret.com)
  340.